home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / RW_RDLOCK.z / RW_RDLOCK
Encoding:
Text File  |  1998-10-30  |  3.5 KB  |  66 lines
  1.  
  2.  
  3.  
  4. RRRRWWWW____RRRRDDDDLLLLOOOOCCCCKKKK((((DDDD3333))))                                                    RRRRWWWW____RRRRDDDDLLLLOOOOCCCCKKKK((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _RRRR_WWWW______RRRR_DDDD_LLLL_OOOO_CCCC_KKKK - acquire a read/write lock in read mode
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_kkkk_ssss_yyyy_nnnn_cccc_hhhh_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _vvvv_oooo_iiii_dddd _RRRR_WWWW______RRRR_DDDD_LLLL_OOOO_CCCC_KKKK_((((_rrrr_wwww_llll_oooo_cccc_kkkk______tttt _****_l_o_c_k_p);
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _l_o_c_k_p     Pointer to the read/write lock to be acquired.
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _RRRR_WWWW______RRRR_DDDD_LLLL_OOOO_CCCC_KKKK acquires the read/write lock specified by _l_o_c_k_p in read mode.
  21.      If the lock is not immediately available in read mode, the caller is put
  22.      to sleep (the caller's execution is suspended and other processes may be
  23.      scheduled) until the lock becomes available to the caller, at which point
  24.      the caller wakes up and returns with the lock held.  A read/write lock is
  25.      available in read mode when the lock is not held by any context in write
  26.      mode.
  27.  
  28.      The caller will not be interrupted by signals while asleep waiting to
  29.      acquire the read/write lock.
  30.  
  31.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  32.      None
  33.  
  34.    LLLLeeeevvvveeeellll
  35.      Base only.
  36.  
  37.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  38.      Can sleep.
  39.  
  40.      Driver-defined basic locks may not be held across calls to this function.
  41.  
  42.      Driver-defined sleep locks may be held across calls to this function
  43.      subject to the recursion restrictions described below.
  44.  
  45.    WWWWaaaarrrrnnnniiiinnnnggggssss
  46.      Multiple calls to _RRRR_WWWW______RRRR_DDDD_LLLL_OOOO_CCCC_KKKK may be made to acquire the same lock, but a
  47.      context that holds a read/write lock in write mode cannot acquire the
  48.      same lock in read mode, and vice versa.
  49.  
  50. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  51.      _RRRR_WWWW______AAAA_LLLL_LLLL_OOOO_CCCC(D3), _RRRR_WWWW______IIII_NNNN_IIII_TTTT(D3), _RRRR_WWWW______DDDD_EEEE_AAAA_LLLL_LLLL_OOOO_CCCC(D3), _RRRR_WWWW______DDDD_EEEE_SSSS_TTTT_RRRR_OOOO_YYYY(D3), _RRRR_WWWW______WWWW_RRRR_LLLL_OOOO_CCCC_KKKK(D3),
  52.      _RRRR_WWWW______UUUU_NNNN_LLLL_OOOO_CCCC_KKKK(D3),
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.